Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

GetTrackClipRgn

The GetTrackClipRgn function allows your application to determine the clipping region of a track.

pascal RgnHandle GetTrackClipRgn (Track theTrack);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

DESCRIPTION

The clipping region is in the track's coordinate system. The Movie Toolbox applies the clipping region to a track before it applies the track's matrix. This region is valid for the entire duration of the track.

The GetTrackClipRgn function allocates the region and returns a handle to the region. Your application must dispose of this region when you are done with it. If the function could not satisfy your request or if there is no clipping region defined for the track, it sets the returned handle to nil.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

Memory Manager errors

SEE ALSO

You can establish a track's clipping region by calling the SetTrackClipRgn function, which is described in the previous section.